home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / elecmail / fido1000.zip / FIDOTECH.TXT < prev    next >
Text File  |  1993-05-21  |  7KB  |  179 lines
  1. THIS DOCUMENT IS FAIRLY SHORT, SO PLEASE READ ALL OF IT BEFORE INSTALLING.
  2.  
  3.         ┌─────────────────────────────────────────────────────────┐
  4.         │   GT Power 16/17 *.MES     Fidonet Interface System     │
  5.         │   Beta Release Date: 04/08/93    Beta Version 0.905     │
  6.         │                                                         │
  7.         │   No fee may be charged for use or distribution.        │
  8.         └─────────────────────────────────────────────────────────┘
  9.  
  10.  
  11. RELEASE DATE IS NOW FINALIZED:          04/30/93
  12.  
  13.     Source code WILL be made publicly available.  It will be uploaded to
  14.     Paul's system in AZ, Perry Alexander's in Lexington, and mine in
  15.     Houston.  Any future independent modifications of this software, and
  16.     redistribution of software based on this code will be coordinated
  17.     through me, but I will not act to impede any independent progress.
  18.     Just let me make the final call on coordinating the various
  19.     potential inputs.   All code submitted becomes subject to the "no
  20.     fee for use or distribution" copyright.
  21.  
  22.  
  23. SYNTAX:
  24.  
  25.        FIDO
  26.  
  27. Concepts:
  28.  
  29.         1.  The gate software tracks messages in three ways.
  30.  
  31.                 a.  Messages imported from fidonet are marked
  32.                     as fido originating.  This is marked by the
  33.                     2nd bit in the flags byte, the one after the
  34.                     sticky bit.
  35.  
  36.                 b.  The "Fido Gate" user record uses the lastread
  37.                     pointer to indicate the last message processed.
  38.                     No messages before this will be scanned out.
  39.  
  40.                 c.  Messages output to fidonet by the gate, but not
  41.                     yet scanned will have the node number encoded in
  42.                     the ftsc header, and if it matches the systems
  43.                     node number, the gate will not import it.
  44.  
  45.         2.  The gate software deletes *.msg files when the following
  46.             conditions occur:
  47.  
  48.                 a.  The message is from Qmail, ie, highwater mark.
  49.  
  50.                 b.  The message has an ^APATH: nnn/xxx where nnn/xxx
  51.                     is the node number of the gate.  ie, scanned out
  52.                     messages originating on the gate system.
  53.  
  54.                 c.  The message is an externally originated message that
  55.                     has been imported.
  56.  
  57.         3.  Maximum message size is about 60k.  (0xF000).  It was
  58.             picked arbitrarily.
  59.  
  60.         4.  Source code will be released with the package at the time
  61.             of its first initial non-beta release.
  62.  
  63.         5.  Anyone may try this software out during the beta test.  I do
  64.             ask that a netmail message be sent to me at 1:106/960.0 or
  65.             001/060.  Please report all bugs to either of these two
  66.             addresses.
  67.  
  68. These concepts are not up for discussion, so if you don't like'em, don't
  69. bother using the software, it didn't cost you anything anyway.
  70.  
  71. ─────────────────────────────────────────────────────────────────────────
  72.  
  73.  
  74. System Assumptions:
  75.  
  76.         1.  I am making the assumption of Binkley and Qmail v1.00
  77.             as the primary interface software on the *.pkt and *.msg
  78.             side.  I have attemted to adjust it for Qmail 1.3x and
  79.             SquishMail *.msg highwater marks as well.
  80.  
  81.         2.  Message bases will be initialized properly on the GT
  82.             side.  (I'm not adding DRAM code to my programs for
  83.             several reasons, one of which is that I program
  84.             religiously in large model.)
  85.  
  86.         3.  You are using GT Power version 16 or higher.
  87.  
  88.         4.  You currently have a valid and functioning fidonet
  89.             system.
  90.  
  91.         5.  That there is a user named "Fido Gate" with an access
  92.             level high enough to prevent accidental deletion from
  93.             inactivity.  (ie, be careful when you delete users with
  94.             the sysop.exe program)
  95.  
  96. ─────────────────────────────────────────────────────────────────────
  97.  
  98.  
  99. Setup instructions:
  100.  
  101.         1.  Configuration file must be in GTPATH: "fidogate.cnf"
  102.  
  103.                 line 1: fidonet z:net/node.point
  104.                 line 2: fidonet origin line text
  105.  
  106.             See the example included.
  107.  
  108.         2.  Login to your bbs using the username of "Fido Gate"
  109.             Access level does not matter.  Or use the SYSOP.EXE
  110.             program provided by P&M software.
  111.  
  112.         3.  Join "Fido Gate" to the message area you wish to gate.
  113.             Either by selecting that area from the BBS or by joining
  114.             with the SYSOP.EXE program.  (be careful when deleteing
  115.             users that you do not accidentally delete Mr. Fido Gate.)
  116.  
  117.         4.  Add the area to your configuration file according to
  118.             the syntax:
  119.  
  120.                 AREA=<mode> <gt directory>  <fido directory>
  121.  
  122.                 AREA=nnnn must be in upper case and have no imbedded spaces.
  123.  
  124.                 Directory entries *MUST* have a trailing backslash.
  125.  
  126.                 Available operating modes:
  127.  
  128.                     0001    Strip high-bit, and ftsc illegals and
  129.                             .ORIGIN/Route: gtnet identifiers.
  130.  
  131.                     0002    Allow high order ascii to pass through
  132.                             but kill control A characters.
  133.  
  134.                     0009    Process fidonet netmail message.  Use
  135.                             the full zone:net/node.point format on
  136.                             line 1, ie, line 1: 1:106/960.0.
  137.  
  138.                             Zone and point data are now properly
  139.                             exported into the fidonet message base,
  140.                             so anyone using this outside of zone
  141.                             one, PLEASE route me netmail message
  142.                             if you can.
  143.  
  144.                     Any other will do no modifications to the text
  145.                     of the messages processed.
  146.  
  147.                     Leading zeros are NOT optional.
  148.  
  149.         5.  Configuration file must have an "END" command after the
  150.             listing of areas, again, case IS critical, "end" will not
  151.             work.
  152.  
  153.  
  154. ────────────────────────────────────────────────────────────────────────
  155. MARKALL:
  156.  
  157.         SYNTAX:
  158.  
  159.                 MARKALL  <msgpath>
  160.  
  161.  
  162.         This little program will mark an entire message base as
  163.         fido originated so that you can convert to the new driver
  164.         with an existing message base, without having to worry
  165.         about duplicates.
  166.  
  167.  
  168.  
  169.  
  170. ────────────────────────────────────────────────────────────────────────
  171.  
  172.                               DISCLAIMER
  173.  
  174.  
  175. I disclaim everything.
  176.  
  177. Simple nuff.
  178.  
  179.